过去的文章和笔记分别保存在 Hexo 与 Obsidian 中,写作、附件管理和发布需要来回切换。借着 Kratos Rebirth 主题升级,我将它们整合到同一个 Git 仓库:在 Obsidian 中写作,用 Hexo 生成博客,通过 Gitea Actions 完成检查与发布。
这次整合没有改变 Hexo 的基本使用方式,主要是统一内容入口,并把私人笔记与博客文章的发布范围分开。
整合思路
三个工具各自负责一件事:
- Obsidian:写文章、整理笔记和管理附件。
- Hexo:读取博客文章,生成静态网站。
- Gitea Actions:检查构建结果,将生成的网站上传到服务器。
Git 保存整个项目,包括私人笔记;网站发布只上传 Hexo 生成的 public/。因此,“需要同步的内容”和“允许公开的内容”可以放在同一个仓库中,分别管理。
目录划分
在 Hexo 项目中建立 vault/,作为唯一的 Obsidian 保险库:
hexo-blog/
├── source/
│ ├── _posts -> ../vault/blog/posts
│ └── images/ # 站点通用图片
├── vault/
│ ├── blog/posts/ # 博客文章与文章附件
│ ├── notes/ # 私人笔记
│ ├── attachments/ # 私人附件
│ ├── template/ # 写作模板
│ └── .obsidian/ # Obsidian 设置
└── .gitea/workflows/ # 构建与发布流程
在 Obsidian 中打开 vault/,Hexo 命令仍在项目根目录执行。
博客文章统一保存在 vault/blog/posts/,由 source/_posts 的符号链接接入 Hexo,避免维护两份文章。私人笔记和附件保存在另外两个目录中,通过 Git 同步,但不链接或复制到 source/,也不随网站部署。
内容与附件整理
迁移时先备份原有内容,再将 Hexo 文章和 Obsidian 笔记按用途归类。原文章的 Front Matter、发布日期和目录层级尽量保留,减少对已有网址的影响。
博客附件放在文章旁的同名目录,使用标准 Markdown 相对路径引用,兼顾 Obsidian 预览和 Hexo 发布。例如:
技术笔记/
├── 示例文章.md
└── 示例文章/
└── 截图.png
文章中写:

本项目通过 Hexo 的文章资源目录配置和独立扩展处理发布路径。私人附件仍留在 vault/attachments/,站点通用图片放在 source/images/。
写作与同步
通过 QuickAdd 和 Templater 提供三个新建入口:普通博客、加密博客和私人笔记。模板负责填写文章头信息,减少重复输入;文章参数和标签组件遵循 Kratos Rebirth 官方文档。
普通博客可以公开发布,非空密码的博客会加密正文;完全不发布的内容放在私人笔记目录。加密博客仍属于网站内容,源文件、密码和附件也不能因此当作已经保密。
Obsidian 的共享设置、社区插件清单和经过检查的白名单插件配置纳入 Git;插件程序、缓存、日志和工作区状态留在本机。换电脑后仍需安装插件,插件清单不会自动完成安装。
多台电脑交替使用时,先在原电脑提交推送,再在另一台拉取后继续编辑。保持一个明确的同步入口,避免 Git 与其他同步工具同时修改同一批文件。
自动检查与发布
Gitea Actions 分为构建检查和正式发布两部分:
- 日常推送:文章、附件或构建配置发生变化时,安装依赖并执行 Hexo 构建检查;仅修改私人笔记时不触发。
- 正式发布:推送
v开头的标签,或手动运行发布工作流,构建完成后保存站点产物,再通过 FTP 上传public/。
构建过程中会检查私人目录是否进入发布路由、加密文章是否正常处理,以及生成页面中的本地图片是否存在。正式发布保留站点产物,便于上传失败后重试,或恢复之前的版本。
这样,日常笔记同步与网站上线可以分开进行,写完内容也可以先预览、检查,再决定何时发布。